Set or unset the filename mapping mechanism. If no
arguments are specified, the filename mapping mechanism
is unset. If arguments are specified, remote filenames
are mapped during _mmmm_pppp_uuuu_tttt commands and _pppp_uuuu_tttt commands issued
without a specified remote target filename. If argu-
ments are specified, local filenames are mapped during
Sun Microsystems Last change: 26 Sep 1992 5
ftp(1) User Commands ftp(1)
_mmmm_gggg_eeee_tttt commands and _gggg_eeee_tttt commands issued without a speci-
fied local target filename.
This command is useful when connecting to a non-UNIX-
system remote host with different file naming conven-
tions or practices. The mapping follows the pattern
set by _i_n_p_a_t_t_e_r_n and _o_u_t_p_a_t_t_e_r_n. _i_n_p_a_t_t_e_r_n is a tem-
plate for incoming filenames (which may have already
been processed according to the _nnnn_tttt_rrrr_aaaa_nnnn_ssss and _cccc_aaaa_ssss_eeee set-
tings). Variable templating is accomplished by includ-
ing the sequences _$$$$_1111, _$$$$_2222, ..., _$$$$_9999 in _i_n_p_a_t_t_e_r_n. Use _\\\\
to prevent this special treatment of the _$$$$ character.
All other characters are treated literally, and are
used to determine the _nnnn_mmmm_aaaa_pppp _i_n_p_a_t_t_e_r_n variable values.
For example, given _i_n_p_a_t_t_e_r_n _$$$$_1111_...._$$$$_2222 and the remote file
name _mmmm_yyyy_dddd_aaaa_tttt_aaaa_...._dddd_aaaa_tttt_aaaa, _$$$$_1111 would have the value _mmmm_yyyy_dddd_aaaa_tttt_aaaa, and
_$$$$_2222 would have the value _dddd_aaaa_tttt_aaaa.
The _o_u_t_p_a_t_t_e_r_n determines the resulting mapped
filename. The sequences _$$$$_1111, _$$$$_2222, ..., _$$$$_9999 are replaced
by any value resulting from the _i_n_p_a_t_t_e_r_n template.
The sequence _$$$$_0000 is replaced by the original filename.
Additionally, the sequence [_s_e_q_1,_s_e_q_2] is replaced by
_s_e_q_1 if _s_e_q_1 is not a null string; otherwise it is
replaced by _s_e_q_2.
For example, the command _nnnn_mmmm_aaaa_pppp _$$$$_1111_...._$$$$_2222_...._$$$$_3333
_[[[[_$$$$_1111_,,,,_$$$$_2222_]]]]_...._[[[[_$$$$_2222_,,,,_ffff_iiii_llll_eeee_]]]] would yield the output filename
_mmmm_yyyy_ffff_iiii_llll_eeee_...._dddd_aaaa_tttt_aaaa for input filenames _mmmm_yyyy_ffff_iiii_llll_eeee_...._dddd_aaaa_tttt_aaaa and
_mmmm_yyyy_ffff_iiii_llll_eeee_...._dddd_aaaa_tttt_aaaa_...._oooo_llll_dddd, _mmmm_yyyy_ffff_iiii_llll_eeee_...._ffff_iiii_llll_eeee for the input filename
_mmmm_yyyy_ffff_iiii_llll_eeee, and _mmmm_yyyy_ffff_iiii_llll_eeee_...._mmmm_yyyy_ffff_iiii_llll_eeee for the input filename
_...._mmmm_yyyy_ffff_iiii_llll_eeee. SPACE characters may be included in _o_u_t_p_a_t_-
_t_e_r_n, as in the example _nnnn_mmmm_aaaa_pppp _$$$$_1111 _|||| _ssss_eeee_dddd _""""_ssss_//// _****_$$$$_////_////_"""" _>>>> _$$$$_1111.
Use the _\\\\ character to prevent special treatment of the